NAME¶

pw-link - pw-link The PipeWire Link Command

SYNOPSIS¶

pw-link [options] -o-l [out-pattern] [in-pattern]

pw-link [options] output input

pw-link [options] -d output input

pw-link [options] -d link-id

DESCRIPTION¶

List, create and destroy links between PipeWire ports.

COMMON OPTIONS¶

-r | --remote=NAME

-h | --help

--version

LISTING PORTS AND LINKS¶

Specify one of -o, -i or -l to list the matching optional input and output ports and their links.

-o | --output

-i | --input

-l | --links

-m | --monitor

-I | --id

-v | --verbose

CONNECTING PORTS¶

Without any list option (-i, -o or -l), the given ports will be linked. Valid port specifications are:

port-id

As obtained with the -I option when listing ports.

node-name:port-name

As obtained when listing ports.

port-object-path

As obtained from the first alternative name for the port when listing them with the -v option.

port-alias

As obtained from the second alternative name for the ports when listing them with the -v option.

Extra options when linking can be given:

-L | --linger

-P | --passive

-p | --props=PROPS

DISCONNECTING PORTS¶

When the -d option is given, an existing link between port is destroyed.

To disconnect port, a single link-id, as obtained when listing links with the -I option, or two port specifications can be given. See the connecting ports section for valid port specifications.

-d | --disconnect

EXAMPLES¶

pw-link -iol

List all port and their links.

pw-link -lm

List all links and monitor changes until pw-link is stopped.

pw-link paplay:output_FL alsa_output.pci-0000_00_1b.0.analog-stereo:playback_FL

Link the given output port to the input port.

pw-link -lI

List links and their Id.

pw-link -d 89

Destroy the link with id 89.

AUTHORS¶

The PipeWire Developers <https://gitlab.freedesktop.org/pipewire/pipewire/issues>; PipeWire is available from <https://pipewire.org>

SEE ALSO¶

pipewire(1), pw-cli(1)